home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Almathera Ten Pack 2: CDPD 1
/
Almathera Ten on Ten - Disc 2: CDPD 1.iso
/
pd
/
051-075
/
058
/
egraph
/
egraph.doc
< prev
next >
Wrap
Text File
|
1995-03-13
|
7KB
|
194 lines
NAME
egraph - a program to graph data
AMIGA version Copyright © Laurence E. Turner 1986
Permission is granted to any individual or educational institution
to use, copy, or redistribute this program so long as it is not
sold and provided that the copyright notice and the UCEE graph
logo are retained.
SYNOPSIS
egraph [-1] [-a] [-g] [-c | -l | -p] [ -h "graph header"]
[ -X | -x number ] [ -Y | -y number ] [-w] [ file1 ]
[ file2 ] [ file3 ] [ file4 ] [ file5 ]
DESCRIPTION
Egraph was developed for use by students and staff of
the Department of Electrical Engineering at the University of
Calgary, Calgary, Alberta, Canada. It is used extensively for
both course work and research. The original UNIX based
version supports many different output devices including
pen plotters, graphics terminals and alphanumeric terminals.
The AMIGA version supports only the AMIGA display and printer.
Egraph reads pairs of x and y values from a list of files
and draws a formated graph.
The default graph mode allows multiple curves to appear
on the same plot for comparison purposes. Four unique curve
fonts are supported: solid curves, dashed curves, dotted curves
and long dashed curves. The fonts are sequenced in the above
order, if more than four curves are to be drawn the above sequence
is repeated as many times as required. For multiple curve plots
simply supply up to five file name arguments to egraph.
The maximum number of data points is unlimited but faster
response time is possible if the number of data points less
than 400.
OPTIONS
-1 one color plot enable (default is multicolor plot)
-a delete the labeled axis and inhibit auto scaling
-g draw a grid over the plotting region
-c pole/zero plot mode, data points of first file
are plotted as crosses, of second file as
circles, data points of all following files are
connected with lines. (default is graph mode)
-l connect all data points with lines (default is
graph mode)
-p plot only data points (default is graph mode)
-h "title string in quotes" Places a title at
the bottom of the graph.
-X plot a standard log scale on the X (horizontal)
axis
-Y plot a standard log scale on the Y (vertical)
axis
-x convert X (horizontal) axis data to log scaling.
The number following -x is the log multiplier.
(used for decibel scaling)
ie.
-x 20 >-performs-> 20 * log10(X)
-y convert Y (vertical) axis data to log scaling.
The number following -y is the log multiplier.
(used for decibel scaling)
ie.
-y 10 >-performs-> 10 * log10(Y)
-P inhibit messages to standard error (Error messages
are not inhibited, info and warnings are). This
was used to prevent message text from being sent
to an HPplotter. If more than one option is chosen
This should be the first option in the option list.
-w Load "egraph.opt" file; All of the above options
can appear in this special file, plus the following
"n" (name axis) and "f" (force scale) options.
n label the graphs axis. A prompt for the
X axis string will appear, followed by a
Y axis string prompt. An axis string is
terminated by a carrage return.
f force scales to user defined values for the
minimum and maximum of the X and Y axis. Prompts
will appear for the minimum, maximum, and number
of major divisions for both the X and Y axis.
if the the number of divisions for either the X
or the X axis is zero, then auto scaling for
that axis is re-enabled.
The format for each option in this file is
(each option appears on it's own line):
h "title string in quotes"
n "X axis label" "Y axis label"
l
p
c
x number
y number
X
Y
g
P
1
a
f Xlow Xhigh numb_X_div Ylow Yhigh numb_Y_div
(note that `w' may NOT appear in this option
file)
EXAMPLE OF AN "egraph.opt" FILE
(everything between the arrows, not including the arrows,
must exist in the file)
->
h "Magnitude response of a 10rd order butterworth filter"
n "FREQUENCY in Hz" "MAGNITUDE in dB"
X
y 20
g
<-
FILES MENU
Input data is read and graphed using file names defined by:
current files: Data file name(s) previously entered
either from the command line or using
the "new files" menu.
new files: Using a requester, enter or modify
the input file name(s).
The "save menu" item, when selected saves the current options
in the file egraph.opt ( in the current directory).
The "about egraph" menu item displays information about egraph.
OPTIONS MENU
This menu allows all of the options described above for the
command line interface to be entered using the menu.
PRINTER MENU
Two screendump modes are supported:
autosize: The aspect ratio is retained while
using the complete page width.
one-to-one: Each screen pixel is mapped to a
printer pixel.
The printer preferences should be set to:
Threshold 8
Negative Image
Black and White
VERSIONS
There is also a UNIX version of egraph called piped.egraph which
does the same thing as egraph but the input file is piped to
it ( for use with applications programs). A multiple graph UNIX
version of egraph (called mgraph)is also available.
AUTHORS
K. Jorgensen, L.E. Turner, M.R. Smith
Department of Electrical Engineering,
The University of Calgary,
Calgary, Alberta, Canada T2N 1N4
BUGS
For further information on egraph or to report bugs,
write to:
Laurence Turner
Department of Electrical Engineering
The University of Calgary
Calgary, Alberta, Canada T2N 1N4